home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat1 / mpvis.z / mpvis
Text File  |  1997-04-03  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMPPPPVVVVIIIISSSS((((1111))))                                                              MMMMPPPPVVVVIIIISSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmppppvvvviiiissss - visualize cpu utilization/performance
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmppppvvvviiiissss [----bbbbCCCCiiiiVVVVzzzz] [----AAAA _a_l_i_g_n] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _n_a_m_e_s_p_a_c_e] [----OOOO _t_i_m_e]
  13.      [----pppp _p_o_r_t] [----SSSS _t_i_m_e] [----tttt _i_n_t_e_r_v_a_l] [----TTTT _t_i_m_e] [----rrrr _r_o_w_l_e_n_g_t_h] [----RRRR _r_o_w_l_e_n_g_t_h]
  14.      [----vvvv _v_e_r_s_i_o_n] [----ZZZZ _t_i_m_e_z_o_n_e] [_X_1_1-_a_r_g_s] [_c_p_u_i_d_l_i_s_t]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      mmmmppppvvvviiiissss displays a three dimensional bar chart of CPU utilization.  The
  18.      display is updated with new values retrieved from the target _h_o_s_t or
  19.      _a_r_c_h_i_v_e every _i_n_t_e_r_v_a_l seconds (default is 2 seconds).
  20.  
  21.      The height of the bars is proportional to the CPU utilization in each of
  22.      the modes iiiiddddlllleeee (with no I/O pending), wwwwaaaaiiiitttt (idle, but waiting for I/O),
  23.      iiiinnnnttttrrrr (interrupt processing), ssssyyyyssss (in the IRIX kernel) and uuuusssseeeerrrr.
  24.  
  25.      In _v_e_r_s_i_o_n 1 all CPUs are displayed in one row.
  26.  
  27.      In _v_e_r_s_i_o_n 2 the number of CPUs per row is governed by the default
  28.      maximum row length, and the options ----bbbb, ----rrrr and ----RRRR.  If none of these
  29.      flags are specified, mmmmppppvvvviiiissss uses the default maximum row length to
  30.      calculate the actual number of rows and columns in the view, according
  31.      to:
  32.  
  33.           nrows = (ncpus + maxrowlen - 1) / maxrowlen
  34.           ncols = (ncpus + nrows - 1) / nrows.
  35.  
  36.      The ----rrrr option uses the above algorithm, but allows the user to override
  37.      the maximum row length.
  38.  
  39.      The CPUs are sorted in ascending order.  They are displayed from left to
  40.      right, and front to back (in the case where there is more than one row of
  41.      CPUs).
  42.  
  43.      The user can specify a list of CPUs in _c_p_u_i_d_l_i_s_t.  If this list is
  44.      specified, only the CPUs in this list are displayed in the view.  The
  45.      list of CPU ids is not sorted.  They are displayed from left to right,
  46.      and front to back (in the case where there is more than one row of CPUs)
  47.      in the order in which they were listed on the command line.
  48.  
  49.      mmmmppppvvvviiiissss generates a ppppmmmmvvvviiiieeeewwww(1) configuration file, and passes most command
  50.      line options to ppppmmmmvvvviiiieeeewwww(1).  Therefore, the command line options ----AAAA, ----aaaa,
  51.      ----CCCC, ----hhhh, ----nnnn, ----OOOO, ----pppp, ----SSSS, ----tttt, ----TTTT, ----ZZZZ and ----zzzz, the _X_1_1-_a_r_g_s and user
  52.      interface are described in the ppppmmmmvvvviiiieeeewwww(1) man page.
  53.  
  54. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  55.      The mmmmppppvvvviiiissss specific options are:
  56.  
  57.      ----bbbb   Use a ratio for row:column of 1:8.  This option is best for large
  58.           numbers of CPUs.  If the row length is not a factor of the number of
  59.           CPUs, then the last row will be shorter than all other rows.  This
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMPPPPVVVVIIIISSSS((((1111))))                                                              MMMMPPPPVVVVIIIISSSS((((1111))))
  71.  
  72.  
  73.  
  74.           option ignores the maximum row length.  Only supported in _v_e_r_s_i_o_n 2
  75.           configuration files.
  76.  
  77.      ----iiii   Label each CPU column with the CPU number. Only supported in _v_e_r_s_i_o_n
  78.           2 configuration files.
  79.  
  80.      ----rrrr   Split the view into a number of rows, where each row has a maximum
  81.           length of _n CPUs.  This is a soft limit.  The actual row length is
  82.           calculated by an algorithm (see above) which prduces a balanced view
  83.           with no more than _n CPUs per row.  Only supported in _v_e_r_s_i_o_n 2
  84.           configuration files.
  85.  
  86.      ----RRRR   Split the view into a number of rows, where each row has a length of
  87.           _n CPUs.  This is a hard limit.  If the row length is not a factor of
  88.           the number of CPUs, then the last row will be shorter than all other
  89.           rows.  Only supported in _v_e_r_s_i_o_n 2 configuration files.
  90.  
  91.      ----vvvv   Generate a _v_e_r_s_i_o_n 1 or 2 configuration file for ppppmmmmvvvviiiieeeewwww(1).  This
  92.           will affect the appearance of the scene although the metrics are the
  93.           same.  The default is version 2.
  94.  
  95.      ----VVVV   Verbose mode - output the generated ppppmmmmvvvviiiieeeewwww(1) configuration file.
  96.  
  97. FFFFIIIILLLLEEEESSSS
  98.      ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....mmmmppppvvvviiiissss
  99.                              A ppppmmmmllllooooggggggggeeeerrrr(1) configuration file for mmmmppppvvvviiiissss
  100.                              metrics.
  101.      ////uuuussssrrrr////ppppccccpppp////lllliiiibbbb////ppppmmmmvvvviiiieeeewwww----aaaarrrrggggssss
  102.                              Shell procedures for parsing ppppmmmmvvvviiiieeeewwww(1) command
  103.                              line options.
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      ddddkkkkvvvviiiissss(1), nnnnffffssssvvvviiiissss(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmllllooooggggggggeeeerrrr(1) and ppppmmmmvvvviiiieeeewwww(1).
  107.  
  108.      The CCCCPPPPUUUU view for ppppmmmmcccchhhhaaaarrrrtttt(1).
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.